home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 38 / Amiga Format CD38 (1999-03-15)(Future Publishing)(GB)(Track 1 of 3)[!][issue 1999-04].iso / -screenplay- / hd_installers / -whdload- / whdload_dev / src / readmefirst < prev    next >
Text File  |  1998-07-16  |  4KB  |  140 lines
  1.  
  2.  
  3.     Here you will find several source code files which will help you in
  4.     developing your own installs using WHDLoad.
  5.  
  6.  
  7.     slave-examples
  8.     --------------
  9.     
  10.     The Slave examples are the recommend reading if you want self write
  11.     Slaves.
  12.     
  13.     winditup.asm:
  14.     this is a very simple Slave to give you an overview how a Slave is
  15.     working, the Slave loads from a disk image and uses the keyboard
  16.     routine provided in the sources directory
  17.  
  18.     oscar.asm:
  19.     this is a simple example for using usual files, it also contains a
  20.     simple exec.AllocMem() emulation which works fine as long as no
  21.     FreeMem() is required
  22.     
  23.     interphase.asm:
  24.     shows the usage of "savegame.s"
  25.     
  26.     turrican.asm
  27.     it shows the usage of "picture.s" and the "blitfix*.s" sources,
  28.     also an example how to use WHDLoad for disk imaging
  29.  
  30.  
  31.     imager-examples
  32.     ---------------
  33.     
  34.     These sources are written to create disk images using "The Patcher".
  35.     Using the Patcher is the prefered way to create images from originals
  36.     with an own diskformat. The advantages against using WHDLoad or custom
  37.     programs are:
  38.       - running fully in multitasking
  39.       - supports DF0: - DF3:
  40.       - easy to debug
  41.       - is stable
  42.     The GUI is currently not very nice (1.3 compatible) but it works fine.
  43.     
  44.     ik+.imager.asm:
  45.     an simple imager for one disk only, a strange decoding routine but 
  46.     nothing special further
  47.  
  48.     bloodmoney.imager.asm:
  49.     this is interesting because the files on the disks are located only
  50.     at lower or upper disk side, therefore the images are created 
  51.     respectively -> first all even tracks and then all odd ones
  52.     (you are a good coder ? then always check your installs also without
  53.     PreLoad or better with FileLog and remember not everbody has tons of 
  54.     megs of memory so that WHDLoad can cache all files... -> avoid 
  55.     endless load orgies)
  56.     
  57.     interphase.imager.asm:
  58.     this imager uses the track display feature of the Patcher v1.05, it
  59.     uses clearly exec.RawDoFmt to format the output string
  60.     
  61.     
  62.     macros
  63.     ------
  64.     
  65.     some macros which are required for some sources
  66.  
  67.  
  68.     pics
  69.     ----
  70.     
  71.     some pictures which are required for some sources
  72.     
  73.     
  74.     programs
  75.     --------
  76.     
  77.     some small tools, maybe useful for you
  78.     
  79.     WCmp:
  80.     simple compare utility, has wide output (16 bytes per line), shows
  81.     only differences, doesn't load whole file but works buffered,
  82.     interruptable with ^C
  83.     
  84.     WDate:
  85.     I use this to insert the date and time of assembling into the
  86.     created executable (see example-slaves)
  87.  
  88.     WVer:
  89.     I use this to increase the revision number each time the source
  90.     will be assembled (similar usage as WDate)
  91.     
  92.     
  93.     sources
  94.     -------
  95.     
  96.     these sources are code fragments containing one or more sub routines,
  97.     they should be used by including them at the bottom of the Slave 
  98.     source and calling from the slave source
  99.     
  100.     blitfix_dn_58a6.s:
  101.     this routine will patch all instructions "move.w dn,($58,a6)" with a
  102.     function which executes the same instruction but waits additional
  103.     after this for the end of the blitter activity, it may be used to
  104.     fix programs which will not correctly wait for blitter finish
  105.     
  106.     blitfix_imm_58a6.s:
  107.     similar to blitfix_dn_58a6.s but patchs all "move.w #xxxx,($58,a6)"
  108.     
  109.     keyboard.s:
  110.     this file contains a complete keyboard initialisation and the required
  111.     interrupt handler, it will be useful for programs without a own
  112.     keyboard handling (most demos) or for programs with broken handling
  113.     (in this case you have to disable the original)
  114.  
  115.     savegames.s:
  116.     this routine contains a system for multiple savegames, there is
  117.     special code which creates a interface to select a save position and
  118.     to enter a description for each    savegame
  119.     
  120.     stfix.s:
  121.     contains a routine to fix the old soundtracker playback routine, this
  122.     old routine used in many games and demos contains an empty dbf loop 
  123.     which wont work correctly on faster machines, the dbf loop will be 
  124.     replaced by a wait based on the vertical raster position
  125.     
  126.  
  127.     PLEASE NOTE
  128.     -----------
  129.  
  130.     My Assembler is able to optimize the addressing mode (and much more):
  131.         (xxxxxxxx).L    -->    (d16,PC)
  132.     if possible.
  133.         
  134.     So I never do this myself !
  135.     Remember Slaves must be 100% PC-relativ !
  136.     So if your Assembler isn't able to do this and you want to use these
  137.     sources you have to add the "(pc)" by yourself. (or just get a better
  138.     assembler!)
  139.  
  140.